home *** CD-ROM | disk | FTP | other *** search
/ Gamers Delight 2 / Gamers Delight 2.iso / Aminet / game / board / wwsolitaire.lha / Solitaire / Klondike.doc < prev    next >
Text File  |  1992-08-19  |  21KB  |  532 lines

  1.  
  2.   Klondike v1.9         Copyright © 1992,  WallyWare    All Rights Reserved
  3.  
  4.                               Software License:
  5.  
  6. Distribution:
  7.   Klondike, in its unaltered entirety, may be distributed freely so long as
  8.   it is not sold and there are no distribution fees.  Commercial enterprises
  9.   must register before distributing Klondike on magnetic media.
  10.  
  11. Usage:
  12.   Like all shareware, you get to try it for free.  Afterwards, if you decide
  13.   to keep it, simply send in a registration.  By doing so, you help someone's
  14.   ends meet, your ideas and opinions influence new and improved programs, and
  15.   you encourage artistic expression from around the globe.  Everyone benefits
  16.   when you support shareware.
  17.  
  18. Registration:
  19.   Please remit $10.00 in US funds by personal or cashiers check drawn on a
  20.   US bank, or a US or international money order.  Please include your name,
  21.   address, and any ideas you'd like to share.
  22.  
  23.   Payable to: Gaylan Wallis         Send to: WallyWare
  24.                                              1324 Parkwoods Terr.
  25.                                              Midwest City, OK  73110-7439
  26.                                              USA
  27.  
  28.        I know not where, Klondike goes,
  29.        Hither, thither, off she flows.
  30.  
  31.        A gem or not, decide, for free,
  32.        But use it lots, and you owe me.
  33.  
  34.  
  35. WallyWare Solitaire:
  36. -------------------
  37.   The most commonly played solitaire game is known widely as Klondike.  It
  38.   might also be known as Patience Solitaire, ChinaMan, Demon Patience,
  39.   Fascination, Canfield or others.  But even more numerous than its names are
  40.   the number of different ways Klondike is played.  Unfortunately, most
  41.   computer solitaire games enforce Hoyle's rules with few exceptions.  So,
  42.   if you like playing by slightly different rules, you're simply out of luck,
  43.   forced to conform.
  44.  
  45.   WallyWare Solitaire not only plays Klondike nicely with low memory/screen
  46.   requirements, you play by the rules of your choice.  Hoyle's rules can be
  47.   either partially or entirely disabled, and there are 5 different ways of
  48.   working through the hand.  There are many other features including a
  49.   Wrap-Up function for when a win is imminent, an Undo function that will
  50.   back up more than one move, a palette requester to fine-tune the colors
  51.   to your liking, and a Save-Setup function that remembers how everything
  52.   is configured.
  53.  
  54.   There are also three optional play modes.  In Sudden-Death, if you miss a
  55.   move the game is over.  In the Near-Death mode, a missed move only gets a
  56.   warning.  With the Move-Indicator ON, you're constantly informed whether a
  57.   legal move is possible and if needed, you can get specifics about the move.
  58.  
  59.   And finally, as a novelty, WallyWare Solitaire plays on its own.  Select
  60.   the AutoPlay function and away it goes.  Makes a nice showroom demo.
  61.  
  62.  
  63. Installation:
  64. ------------
  65.   With WorkBench, drag either the Klondike directory icon, or all of its
  66.   files to where you want Klondike installed.
  67.  
  68.   Klondike files:
  69.   --------------
  70.     Klondike           WallyWare Solitaire Game        68244 bytes
  71.     Klondike.info        its icon                       1270
  72.     Klondike.cards     Card Images (has no icon)       41022
  73.     Klondike.doc       Documentation                   21298
  74.     Klondike.doc.info    its icon                        315
  75.                                                    ---------------
  76.     total disk space needed: 259 free blocks          132149 bytes
  77.  
  78.     ** A Klondike.settings file may later require another 44 bytes
  79.  
  80.   It is IMPORTANT that both the document and card-images files be available
  81.   to Klondike.  See the alternate installation scheme if Klondike has trouble
  82.   finding files.
  83.  
  84.  
  85. Upgrading:
  86. ---------
  87.   If you're upgrading a previous version of Klondike, the 5 files listed
  88.   above, replace their earlier counterparts.  Your existing settings file
  89.   will be utilized by the newer Klondike.  See Changes v1.9 listed below.
  90.  
  91.  
  92. In a Nut-Shell:
  93. --------------
  94.   When Klondike is started, it displays the software license, initializes
  95.   program variables and prompts the user to press anything to begin playing.
  96.   Once the cards have finished dealing, you're ready to play the first game.
  97.  
  98.   Cards are moved by positioning the cursor over the card to be moved, and
  99.   grabbing it by holding down on the left mouse button.  Continue holding
  100.   down on the mouse button and move the card to its new position.  Release
  101.   the mouse button to drop the card.  Several cards can be moved in a single
  102.   motion by grabbing the deepest card of the pile to be moved.
  103.  
  104.   Cards are dealt according to the dealmode when the deck or hand at the
  105.   (upperleft) is clicked.  If the dealmode allows for multiple passes through
  106.   the hand, clicking the hand position when its empty will pickup the waste
  107.   pile (talon), in preparation for another pass through the hand.  The menus
  108.   can be used to start new games, change the options and rules, quit...
  109.  
  110.  
  111. According to "Hoyle":
  112. --------------------
  113.   28 cards are dealt to 7 piles called the tableau.  The object is to move
  114.   all of the cards to the top 4 piles called foundations.
  115.  
  116.   On the tableau piles, you can build in descending sequence, red on black,
  117.   or black on red.  Multiple cards may also be moved in the tableau and only
  118.   Kings are allowed to be played in an open tableau pile.
  119.  
  120.   When an Ace is freed, it is played in a foundation pile.  Thereafter, you
  121.   may build on the foundations in ascending sequence of the same suit.  Once
  122.   a card has been played in a foundation, it may not be moved.
  123.  
  124.   The cards remaining after the deal are called the hand.  There are two
  125.   common methods for working through the hand.  In the one card mode, each
  126.   consecutive card in the hand is turned up and placed in the waste pile.
  127.   The top card in the waste pile is always available to be played.  The game
  128.   ends after the stack has been gone through once.  In the 3 card mode, three
  129.   cards at a time are dealt from the hand to the waste pile but you may make
  130.   as many passes through the hand as necessary.
  131.  
  132.  
  133. Klondike Menus and Keyboard Shortcuts:
  134. -------------------------------------
  135.   The Right Mouse Button can be used to activate menu items.  When a check-
  136.   mark character is shown with a menu item, the option or rule is turned ON.
  137.   Multiple menu selections can be made by using the left button along with
  138.   the right button.  Shortcuts are available for most of the menu functions
  139.   or settings.  The keyboard shortcuts can be activated the AmigaOS way, by
  140.   using the right Amiga key inconjunction with the hot key, or by simply
  141.   pressing the hot key by itself.
  142.  
  143.  
  144. Game Menu      Hot-Key:
  145. -----------------------
  146.   New Game        N
  147.     Each time a new game is started, your bank balance is charged 50 dollars,
  148.     the cards are reshuffled then dealt, and it's ready for play.
  149.  
  150.   Chapter 7       7
  151.     Sets the bank balance to zero prior to starting a new game.
  152.  
  153.   Undo Last Move  U
  154.     The Undo function uses a history buffer to record upto 400 card movements
  155.     within a game.  Activating this function will undo moves in their reverse
  156.     sequence.  Repeated activation will return a game to its initial starting
  157.     condition.
  158.  
  159.   Wally Warp-Up   W
  160.     Its purpose is to eliminate the formality of moving cards to foundations
  161.     when a win is imminent.  When activated, as many cards as possible are
  162.     moved to foundations.  If all the cards make it to the foundations, a
  163.     victory is scored and bank balance gets a bonus.  As it turned out,
  164.     this also works nicely when a number of cards need to be moved to the
  165.     foundations and you just feel lazy.
  166.  
  167.   Concede Game    C
  168.     Select this function to see the hidden cards after a game has reached
  169.     its conclusion.  After a Concede game function, play is still possible.
  170.     It will probably be confusing though, since the cards that were just
  171.     turned up are still considered hidden and so unmovable until they are
  172.     really turned up.
  173.  
  174.   AutoPlay        A
  175.     Starts the computer playing on its own.  Play continues until a mouse or
  176.     keyboard event occurs, which means you can press the A key repeatedly to
  177.     stop/start playing.
  178.  
  179.   Save Setup      S
  180.     This function saves the current menu options and rules so that this
  181.     arrangement is restored the next time you play Klondike.  It normally
  182.     creates a file named "Klondike.settings" in the current directory.
  183.     In the alternate installation scheme, the settings file is read from
  184.     and written to volume KLONDIKE:.
  185.  
  186.   Quit            Q
  187.     Ends the Game.  An inadvertant press of a bare Q key is protected with
  188.     a confirmation requester.
  189.  
  190.  
  191. Options Menu    Hot Key:
  192. ------------------------
  193.   1-Card 1-Pass    1
  194.     Deals 1 card at a time, and allows only one pass through the hand.
  195.  
  196.   3-Card 3-Passes  2
  197.     Deals 3 cards at a time, and allows only three passes through the hand.
  198.  
  199.   3-Card N-Passes  3
  200.     Deals 3 cards at a time, and allows unlimited passes through the hand.
  201.  
  202.   3-Card N-P.Rev.  4
  203.     Deals 3 cards at a time, but their order is reversed as they are moved
  204.     from the hand to the waste pile.  Allows unlimited passes through the
  205.     hand.  It takes two complete passes through the hand without a play
  206.     before a game concludes.
  207.  
  208.   1-Card N-Passes  5
  209.     Deals 1 card at a time, and allows unlimited passes through the hand.
  210.  
  211.  
  212. Rules Menu     Hot-Key:
  213. -----------------------
  214.   All Rules Off   -
  215.     Turns all five rules OFF.
  216.  
  217.   Non-Movable Partial Stacks
  218.     This rule prevents you from moving partial stacks in the tableau.
  219.     After cards are played in the tableau, they can be moved only a
  220.     few ways; from the top of a stack to a foundation, as part of all
  221.     the cards that are face up in that stack or to an empty tableau.
  222.     The rule is enforced by allowing you to move only cards that are
  223.     the first face-up card from the bottom (screen top) of the stack.
  224.  
  225.   Non-Movable Foundations
  226.     This rule prevents you from moving cards once they have been played on
  227.     a foundation.
  228.  
  229.   Kings Only on Empty Stacks
  230.     This rule allows only Kings to be played in empty tableau piles.
  231.  
  232.   Normal Foundation Rules
  233.     This rule consist of two parts.  An Ace must be the first card played
  234.     in an empty foundation.  Afterwards, cards played in the foundation must
  235.     be one value higher and of the same suit as the card its played on.
  236.  
  237.   Normal Tableau Rules
  238.     Cards played in the tableau must be of the opposite color and one value
  239.     lower than the card its played on.
  240.  
  241.   All Rules On    =
  242.     Turns all 5 rules ON.
  243.     There is a small quirk when this function is selected using the multiple
  244.     menu selection feature of AmigaDOS.  The check marks beside the five
  245.     rules will not appear until after the mouse buttons have been released
  246.     and the menu reactivated.
  247.  
  248.  
  249. Extras Menu    Hot-Key:
  250. -----------------------
  251.   Move Indicator  M
  252.     When ON, a little box that says PLAY will appear whenever a legal move
  253.     is possible.  Click the PLAY box if you need more information about the
  254.     move.
  255.  
  256.   Near Death      N
  257.     In this mode, you cannot deal cards from the hand until all the legal
  258.     moves have been made.
  259.  
  260.   Sudden Death    D
  261.     When sudden death is ON, if you miss a play you're history.  Be sure
  262.     all the plays have been made before clicking the hand to turn up more
  263.     cards.
  264.  
  265.   Fast Moves      F
  266.     When ON, the card movements are faster.
  267.  
  268.   Spread Talon x  X
  269.     With this option ON, dealt cards are spread horizontally so that you
  270.     can see the last three cards dealt.
  271.  
  272.   Spread Talon y  Y
  273.     With this option ON, dealt cards are spread vertically down the screen,
  274.     so that you can view all of the cards in the waste pile.  Turn both
  275.     Spread Talon functions OFF to view only the last card dealt.
  276.  
  277.   Palette         P
  278.     A simple Palette requester to fine-tune the colors for your monitor.
  279.  
  280.  
  281. Rules Discussion:
  282. ----------------
  283.   Hoyle's rules are implemented in five parts so to allow for a number of
  284.   common play variations while still enforcing a set of rules.  Still, you
  285.   can turn them all OFF and move cards about freely.  By manually enforcing
  286.   your own choice of rules you can play a popular variation of Solitaire
  287.   known as How-Many-Times-Do-I-Have-To-Cheat-To-Win.
  288.  
  289.   Don't be surprised if you get unexpected results when only a part of the
  290.   rules are disabled.  While one rule might seem to allow a particular
  291.   move, another rule may still prevent it.
  292.  
  293.  
  294. Scoring:
  295. -------
  296.   The scoring method employed is based on a 50 dollar charge for playing a
  297.   game, and a 5 dollar pay back for every card you move to a foundation.
  298.   If all 52 cards make it to the foundations, then a bonus is included which
  299.   makes a total score of 500 dollars, or a net profit of $450.
  300.  
  301.  
  302. AutoPlay Logic:
  303. --------------
  304.   Compared to the decision making processes of humans playing solitaire,
  305.   AutoPlay's is bare bones.  While it distinguishes between plays that move
  306.   cards to the foundations and plays that move cards to a tableau pile, it
  307.   does not recognize multiple plays.  The first move it finds is the move
  308.   it makes.
  309.  
  310.          Start:
  311.            Make plays to the tableau until there are none.
  312.  
  313.            If there is a move to one of the foundations then
  314.              Make the move then
  315.              Goto start.
  316.  
  317.            If there is at least one card remaining in the hand then
  318.              Deal once from the hand then
  319.              Goto start.
  320.  
  321.            Ready the hand for another pass by picking up the waste pile.
  322.  
  323.            If the game is over, which depends on the dealmode, then
  324.              Start a new game.
  325.  
  326.            Goto start.
  327.  
  328.  
  329.   A variation of this method, which plays cards to the foundations as a
  330.   first priority produced 10 to 20 percent lower returns for all dealmodes.
  331.  
  332.  
  333. AutoPlay Experiment:
  334. -------------------
  335.   Out of curiosity, I've wanted to know how the various dealmodes affect
  336.   the odds of making money playing solitaire.  To speed things up, I
  337.   stripped everything possible from the program.  Without all the whistles
  338.   and bells, Klondike plays almost 4 games/second on an A3000.
  339.  
  340.   The following data was gathered using ten 10,000 game sessions for each
  341.   dealmode.
  342.                               ave                ave
  343.                              %Games  std.       return   std.
  344.         DealMode              Won    dev.       /game    dev.
  345.         =====================================================
  346.         1-Card 1-Pass         1.85   .15        -4.63    .88
  347.  
  348.         3-Card 3-Passes       3.05   .11        -5.90    .56
  349.  
  350.         3-Card N-Passes       6.74   .20        14.62   1.00
  351.  
  352.         3-Card N-Pass Rev.   21.78   .43        95.41   1.93
  353.  
  354.         1-Card N-Passes      26.38   .69       118.94   3.04
  355.  
  356.  
  357.   Its interesting that while the average loss per game in the first two
  358.   dealmodes are about the same, the number of wins in the 3-Card 3-Pass mode
  359.   is much higher.  I guess you don't win as often in the 1-Card 1-Pass mode,
  360.   but when you lose, you don't lose as bad.
  361.  
  362.   After 1 million games in the 3-card N-Passes mode, Klondike averaged
  363.   14.57 profit per game and won 6.72 percent of the time.
  364.  
  365.   Again, these results are based on a very simple play strategy.  A human
  366.   can improve them by selecting plays intelligently.
  367.  
  368.  
  369. Alternate Installation Scheme:
  370. -----------------------------
  371.   If for some reason you want to start Klondike from the CLI, and from a
  372.   different directory than where Klondike's files are stored, this will
  373.   interest you.  The problem with the normal installation is that Klondike
  374.   won't be able to find its support files.
  375.  
  376.   To remedy this situation, ASSIGN KLONDIKE: (to your Klondike's directory).
  377.   When Klondike is first started, is tries to find the document file in the
  378.   current directory.  If found, all support files will be read from and
  379.   written to the current directory.  If the doc wasn't found in the current
  380.   directory, it tries volume KLONDIKE: and uses that directory if it can
  381.   find the doc.  If the doc isn't found in either of these directories,
  382.   Klondike exits.
  383.  
  384.  
  385. Changes v1.19:
  386. -------------
  387.   New Autoplay function.  Computer plays on its own until a mouse or
  388.   keyboard event occurs.
  389.  
  390.   New Undo function.  Uses a history buffer to undo moves.  Remembers
  391.   upto 400 moves.
  392.  
  393.   New Concede game function to view the face-down cards when there
  394.   are no more moves.
  395.  
  396.   Modified the Move indicator mode so that clicking the Play box will tell
  397.   you which card can be played. (Jeff Lavin)
  398.  
  399.   Expanded the logic for finding and handling support files.
  400.   Support files may be kept in the current directory or the assigned
  401.   directory KLONDIKE:.  The location the document file determines
  402.   where the remaining support files are expected to be and where the
  403.   settings file is saved. (James Sherman)
  404.  
  405.   Fixed the only known bug, in the hot-key menu shortcuts.   The qualifying
  406.   Right-Amiga key wasn't supposed to be required.
  407.  
  408.   Separated the Spread Talon option into its x and y components.  Turn them
  409.   both off to see only the top card in the waste pile. (Bill Falls)
  410.  
  411.   This ended up changing the size of settings file.
  412.   Klondike v1.9 can read either settings file, but writes only new ones.
  413.   Klondike v1.8 ignores the newer settings files.
  414.  
  415.   Added ability to abort a WallyWarpUp.  Any mouse or keyboard event serves
  416.   to halt the Warp.
  417.  
  418.   Shuffles are more thorough and still efficient. (Jeff Lavin)
  419.  
  420.   The 3-Card n-passes Rev dealmode now uses a hidden pile, just right of
  421.   the hand, which ends up showing the cards being reversed as they are
  422.   dealt.  This cleaned up my voodoo code in the reverse dealmode, which
  423.   was needed to complete the Undo function.
  424.  
  425.   Fixed the unreported bug in the keyboard menu shortcuts.   The qualifying
  426.   right-Amiga key isn't required to activate a menu item from the keyboard.
  427.  
  428.   Changed the input handling so that you can double-click ahead when dealing
  429.   from the hand, so long as your not in the sudden-death mode. (Bob Starkey)
  430.  
  431.   Minor changes to a few of the card images.
  432.  
  433.  
  434. Klondike Trivia:
  435. ---------------
  436.   In 1897, news of a gold strike on a tributary of the Yukon made the name
  437.   "Klondike" famous.  The word "Klondike" is thought to be a corruption of
  438.   "Thron-diuck", an Indian word which translates as "hammer water".  It is
  439.   said to be derived from the fact that the natives drove stakes across the
  440.   shallow mouth of the stream as anchors for their salmon nets.
  441.  
  442.   Of coincidence, is the fact that another game of solitaire called Canfield,
  443.   was being played about the same time that news of the gold strike was heard.
  444.   A proprietor of a famous gambling dive at Saratoga made a fortune charging
  445.   $50 per deck and paying $5 for every card played to a foundation.  Even
  446.   though the rules of Canfield solitaire resemble Klondike's, the odds of
  447.   winning proved much to Mr. Canfield's advantage.
  448.  
  449.   "Games for one player are childish and simple, and are not worth learning.
  450.   When a man is reduced to such a pass as playing cards by himself, he had
  451.   better give up..."
  452.     Captain Crawley, "The Card Players Manual", 1876
  453.  
  454.   "Patience is the mental equivalent of jogging.  Its purpose is to tone the
  455.   brain up and get rid of unsociable flabbiness."
  456.     David Parlett,  "The Penguin Book of Card Games", 1979
  457.  
  458.  
  459. Quirks:
  460. ------
  461.   Intuition doesn't provide a means of turning ON several menu checkmarks
  462.   internally, so using the multiple menu select feature of AmigaOS to turn
  463.   ON all the rules doesn't show the checkmarks until the right mouse button
  464.   is released and the menu is reactivated.
  465.  
  466.   Too bad we don't have a MutualInclude field in the MenuItem structure that
  467.   would turn MenuItems ON the way the MutualExclude field turns them OFF.
  468.  
  469.   Still minor font problem in the menus when the system default font is
  470.   larger that TOPAZ 8.
  471.  
  472.   Moving cards flutter.  I needs to use the Amiga's bobs instead of....
  473.  
  474.   A few when moving cards which exist off the bottom of the screen.
  475.  
  476.  
  477. Wish List:
  478. ---------
  479.   1) Reset Game/Undo All function.
  480.  
  481.   2) 600x400x3 graphics.  Card images with rounded see-through corners and
  482.      faster smoother graphics.
  483.  
  484.   3) Compete against other players, human and or computer.
  485.  
  486.   4) Compete in several scenarios, where a certain condition determines the
  487.      end of the competition.  Be able to limit the number of games in a session
  488.      or ending when the balance reaches a particular level.
  489.  
  490.   5) Be able to enter a starting balance.
  491.  
  492.   6) Keep accounts and histories for multiple players.
  493.  
  494.   7) Ability to double-click and automatically move a card to its foundation.
  495.  
  496.   8) Ability to use a DPaint brush as the image for the back of the cards.
  497.  
  498.   9) A penny for every game of WallyWare Solitaire played.
  499.  
  500.   Your input welcome!
  501.  
  502.  
  503.  
  504. THANKS! to:
  505. ----------
  506.   Bob Starkey, imagery and program design.
  507.   Randy Evers,
  508.   Alan McMindes and family, for torture testing.
  509.   Mike McDougal,
  510.   many members of the Oklahoma City Amiga user group, OACES.
  511.   and to everyone that sent in a registration for v1.8.
  512.     Your suggestions and contributions were very helpful.
  513.  
  514.  
  515. Bit Artist:
  516. ----------
  517.   Gaylan Wallis
  518.  
  519.   WallyWare
  520.   1324 Parkwoods Terr.
  521.   Midwest City, OK  73110-7439
  522.   USA
  523.  
  524.   Residence/business  Voice 405-733-2768
  525.  
  526.   BIX:  gwallis
  527.  
  528.   Amy Source BBS  405-793-1097  24hr 1200-14400
  529.  
  530.   Amiga Line BBS  405-324-8061  24hr 1200-2400
  531.  
  532.